// 版权所有2009 Go作者。版权所有。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// 包jpeg实现了一个jpeg图像解码器和编码器。
// 
// JPEG在ITU-T T.81中定义：https:
package jpeg

import (
	"image"
	"image/color"
	"image/internal/imageutil"
	"io"
)

// FormatError报告输入不是有效的JPEG。
type FormatError string

func (e FormatError) Error() string { return "invalid JPEG format: " + string(e) }

// 不支持错误报告输入使用了有效但未实现的JPEG功能。
type UnsupportedError string

func (e UnsupportedError) Error() string { return "unsupported JPEG feature: " + string(e) }

var errUnsupportedSubsamplingRatio = UnsupportedError("luma/chroma subsampling ratio")

// 部件规范，见第B.2.2节。
type component struct {
	h  int   // 水平采样因子。
	v  int   // 垂直采样因子。
	c  uint8 // 组件标识符。
	tq uint8 // 量化表目标选择器。
}

const (
	dcTable = 0
	acTable = 1
	maxTc   = 1
	maxTh   = 3
	maxTq   = 3

	maxComponents = 4
)

const (
	sof0Marker = 0xc0 // 帧的开始（基线顺序）。
	sof1Marker = 0xc1 // 帧的开始（扩展顺序）。
	sof2Marker = 0xc2 // 帧的开始（渐进式）。
	dhtMarker  = 0xc4 // 定义哈夫曼表。
	rst0Marker = 0xd0 // 重新启动（0）。
	rst7Marker = 0xd7 // 重新启动（7）。
	soiMarker  = 0xd8 // 图像开始。
	eoiMarker  = 0xd9 // 图像结束。
	sosMarker  = 0xda // 开始扫描。
	dqtMarker  = 0xdb // 定义量化表。
	driMarker  = 0xdd // 定义重启间隔。
	comMarker  = 0xfe // 评论。
	// “特定于应用程序”的标记本身不属于JPEG规范的一部分，但实际上，它们的用法在
	// https:
	app0Marker  = 0xe0
	app14Marker = 0xee
	app15Marker = 0xef
)

// 中有描述，请参见https:
const (
	adobeTransformUnknown = 0
	adobeTransformYCbCr   = 1
	adobeTransformYCbCrK  = 2
)

// 将之字形映射从之字形顺序解压为自然顺序。例如，
// unzig[3]是第四个元素的行和列，按之字形排列。
// 值为16，表示第一列（16%8==0）和第三行（16/8==2）。
var unzig = [blockSize]int{
	0, 1, 8, 16, 9, 2, 3, 10,
	17, 24, 32, 25, 18, 11, 4, 5,
	12, 19, 26, 33, 40, 48, 41, 34,
	27, 20, 13, 6, 7, 14, 21, 28,
	35, 42, 49, 56, 57, 50, 43, 36,
	29, 22, 15, 23, 30, 37, 44, 51,
	58, 59, 52, 45, 38, 31, 39, 46,
	53, 60, 61, 54, 47, 55, 62, 63,
}

// 不推荐使用：图像/jpeg包不使用读卡器，其他人不应使用
// 读卡器。它是为了兼容而保存的。
type Reader interface {
	io.ByteReader
	io.Reader
}

// 位保存从字节流中获取的未处理位。
// 从MSB到
// LSB顺序读取的未读位形式的n个最低有效位。
type bits struct {
	a uint32 // 蓄电池。
	m uint32 // 面具。当n>0时，m==1<<（n-1），当n==0时，m==0。
	n int32  // a中未读的位数。
}

type decoder struct {
	r    io.Reader
	bits bits
	// 字节是一个字节缓冲区，类似于bufio.Reader，只是由于字节填充，它必须能够读取超过1个字节。
	// 第F.1.2.3节规定了字节填充。
	bytes struct {
		// buf[i:j]是从基础
		// /io.Reader读取的缓冲字节，尚未进一步传递。
		buf  [4096]byte
		i, j int
		// 不可读是在
		// 过调后备份i的字节数。它可以是0、1或2。
		nUnreadable int
	}
	width, height int

	img1        *image.Gray
	img3        *image.YCbCr
	blackPix    []byte
	blackStride int

	ri    int // 重新启动间隔。
	nComp int

	// 根据第4.5节，有四种操作模式（由
	// 软件标记选择）：顺序DCT、渐进DCT、无损和
	// 分层，尽管此实现不支持后一种
	// 两种非DCT模式。根据第4.11节，顺序DCT进一步分为基线和
	// 扩展。
	baseline    bool
	progressive bool

	jfif                bool
	adobeTransformValid bool
	adobeTransform      uint8
	eobRun              uint16 // 第G.1.2.2节规定的频带结束运行。

	comp       [maxComponents]component
	progCoeffs [maxComponents][]block // 渐进模式扫描之间的保存状态。
	huff       [maxTc + 1][maxTh + 1]huffman
	quant      [maxTq + 1]block // 量化表，以之字形顺序排列。
	tmp        [2 * blockSize]byte
}

// fill从底层io.Reader填充d.bytes.buf缓冲区。只有当d.bytes中没有未读字节时，才应该调用它
// 。
func (d *decoder) fill() error {
	if d.bytes.i != d.bytes.j {
		panic("jpeg: fill called when unread bytes exist")
	}
	// 将最后2个字节移到缓冲区的开头，以防我们需要
	// 调用unreadByteStuffedByte。
	if d.bytes.j > 2 {
		d.bytes.buf[0] = d.bytes.buf[d.bytes.j-2]
		d.bytes.buf[1] = d.bytes.buf[d.bytes.j-1]
		d.bytes.i, d.bytes.j = 2, 2
	}
	// 填充缓冲区的其余部分。
	n, err := d.r.Read(d.bytes.buf[d.bytes.j:])
	d.bytes.j += n
	if n > 0 {
		err = nil
	}
	return err
}

// unreadByteStuffedByte撤消最近的readByteStuffedByte调用，
// 将一个字节的数据从d.bits返回到d.bytes。哈夫曼查找表
// 需要至少8位进行查找，这意味着哈夫曼解码有时会超出范围，读取一个或两个过多字节。当期望读取0xff 0x00字节填充字节时，可能会发生双字节超调
// 情况。
func (d *decoder) unreadByteStuffedByte() {
	d.bytes.i -= d.bytes.nUnreadable
	d.bytes.nUnreadable = 0
	if d.bits.n >= 8 {
		d.bits.a >>= 8
		d.bits.n -= 8
		d.bits.m >>= 8
	}
}

// readByte返回下一个字节，无论是否已缓冲。它不在乎字节填充。
func (d *decoder) readByte() (x byte, err error) {
	for d.bytes.i == d.bytes.j {
		if err = d.fill(); err != nil {
			return 0, err
		}
	}
	x = d.bytes.buf[d.bytes.i]
	d.bytes.i++
	d.bytes.nUnreadable = 0
	return x, nil
}

// errMissingFF00表示readByteStuffedByte遇到的0xff字节（
// 标记字节）不是预期的字节填充序列0xff，0x00。
var errMissingFF00 = FormatError("missing 0xff00 sequence")

// readByteStuffedByte类似于readByte，但用于填充字节的哈夫曼数据。
func (d *decoder) readByteStuffedByte() (x byte, err error) {
	// 如果d.bytes.buf至少包含两个字节，则采用快速路径。
	if d.bytes.i+2 <= d.bytes.j {
		x = d.bytes.buf[d.bytes.i]
		d.bytes.i++
		d.bytes.nUnreadable = 1
		if x != 0xff {
			return x, err
		}
		if d.bytes.buf[d.bytes.i] != 0x00 {
			return 0, errMissingFF00
		}
		d.bytes.i++
		d.bytes.nUnreadable = 2
		return 0xff, nil
	}

	d.bytes.nUnreadable = 0

	x, err = d.readByte()
	if err != nil {
		return 0, err
	}
	d.bytes.nUnreadable = 1
	if x != 0xff {
		return x, nil
	}

	x, err = d.readByte()
	if err != nil {
		return 0, err
	}
	d.bytes.nUnreadable = 2
	if x != 0x00 {
		return 0, errMissingFF00
	}
	return 0xff, nil
}

// readFull将len（p）字节精确读取到p中。它不关心字节
// /填料。
func (d *decoder) readFull(p []byte) error {
	// 未读取超出的字节（如果有）。
	if d.bytes.nUnreadable != 0 {
		if d.bits.n >= 8 {
			d.unreadByteStuffedByte()
		}
		d.bytes.nUnreadable = 0
	}

	for {
		n := copy(p, d.bytes.buf[d.bytes.i:d.bytes.j])
		p = p[n:]
		d.bytes.i += n
		if len(p) == 0 {
			break
		}
		if err := d.fill(); err != nil {
			if err == io.EOF {
				err = io.ErrUnexpectedEOF
			}
			return err
		}
	}
	return nil
}

// 忽略接下来的n个字节。
func (d *decoder) ignore(n int) error {
	// 未读取超出的字节（如果有）。
	if d.bytes.nUnreadable != 0 {
		if d.bits.n >= 8 {
			d.unreadByteStuffedByte()
		}
		d.bytes.nUnreadable = 0
	}

	for {
		m := d.bytes.j - d.bytes.i
		if m > n {
			m = n
		}
		d.bytes.i += m
		n -= m
		if n == 0 {
			break
		}
		if err := d.fill(); err != nil {
			if err == io.EOF {
				err = io.ErrUnexpectedEOF
			}
			return err
		}
	}
	return nil
}

// 在第B.2.2节中规定。
func (d *decoder) processSOF(n int) error {
	if d.nComp != 0 {
		return FormatError("multiple SOF markers")
	}
	switch n {
	case 6 + 3*1: // 灰度图像。
		d.nComp = 1
	case 6 + 3*3: // YCbCr或RGB图像。
		d.nComp = 3
	case 6 + 3*4: // YCbCrK或CMYK图像。
		d.nComp = 4
	default:
		return UnsupportedError("number of components")
	}
	if err := d.readFull(d.tmp[:n]); err != nil {
		return err
	}
	// 我们只支持8位精度。
	if d.tmp[0] != 8 {
		return UnsupportedError("precision")
	}
	d.height = int(d.tmp[1])<<8 + int(d.tmp[2])
	d.width = int(d.tmp[3])<<8 + int(d.tmp[4])
	if int(d.tmp[5]) != d.nComp {
		return FormatError("SOF has wrong length")
	}

	for i := 0; i < d.nComp; i++ {
		d.comp[i].c = d.tmp[6+3*i]
		// 第B.2.2节规定“C_i的值应不同于
		// C_1至C_（i-1）的值”。
		for j := 0; j < i; j++ {
			if d.comp[i].c == d.comp[j].c {
				return FormatError("repeated component identifier")
			}
		}

		d.comp[i].tq = d.tmp[8+3*i]
		if d.comp[i].tq > maxTq {
			return FormatError("bad Tq value")
		}

		hv := d.tmp[7+3*i]
		h, v := int(hv>>4), int(hv&0x0f)
		if h < 1 || 4 < h || v < 1 || 4 < v {
			return FormatError("luma/chroma subsampling ratio")
		}
		if h == 3 || v == 3 {
			return errUnsupportedSubsamplingRatio
		}
		switch d.nComp {
		case 1:
			// 如果JPEG图像只有一个分量，a.2节说“此数据
			// 根据定义是非交错的”，a.2.2节说“[在这种情况下，…]无论H_1和V_1”的值如何，扫描中数据单元的顺序应为从左到右
			// 和从上到下。第
			// 4.8.2节还规定“[对于非交错数据]，MCU定义为
			// /一个数据单元”。类似地，第A.1.1节解释说，重要的是H_i与max_j（H_j）的比值
			// 对于灰度
			// 图像，H_1是所有分量j的最大H_j，因此该比值
			// 始终为1。组件的（h，v）有效地总是（1，1）：即使
			// 标称（h，v）是（2，1），20x5图像编码为三个8x8 
			// MCU，而不是两个16x8 MCU。
			h, v = 1, 1

		case 3:
			// 对于YCbCr图像，我们仅支持4:4:4、4:4:0、4:2:2、4:2:0、
			// 4:1:1或4:1:0色度子采样比率。这意味着Y分量的
			// （h，v）值为（1,1）、（1,2）、
			// （2,1）、（2,2）、（4,1）或（4,2），Y分量的值
			// 必须是Cb和Cr分量值的倍数。我们还假设两个色度分量具有相同的子采样比率。
			switch i {
			case 0: // Y.
				// 我们已经在上面验证了h和v都是
				// 1、2或4，所以无效的（h、v）组合是那些v=4的
				// 组合。
				if v == 4 {
					return errUnsupportedSubsamplingRatio
				}
			case 1: // Cb。
				if d.comp[0].h%h != 0 || d.comp[0].v%v != 0 {
					return errUnsupportedSubsamplingRatio
				}
			case 2: // Cr.
				if d.comp[1].h != h || d.comp[1].v != v {
					return errUnsupportedSubsamplingRatio
				}
			}

		case 4:
			// 对于四分量图像（CMYK或YCbCrK），我们仅支持两个
			// hv向量：[0x11 0x11]和[0x22 0x11 0x11 0x22]。
			// 理论上，四分量JPEG图像可以混合和匹配hv值
			// 但在实践中，这两种组合是唯一使用的组合，
			// 如果我们可以假设：
			// /-对于CMYK，C和K通道具有完整的采样，如果M 
			// 和Y通道子采样，则它们在水平方向和垂直方向上都是子采样。
			// /-对于YCbCrK，Y和K通道具有完整采样。
			switch i {
			case 0:
				if hv != 0x11 && hv != 0x22 {
					return errUnsupportedSubsamplingRatio
				}
			case 1, 2:
				if hv != 0x11 {
					return errUnsupportedSubsamplingRatio
				}
			case 3:
				if d.comp[0].h != h || d.comp[0].v != v {
					return errUnsupportedSubsamplingRatio
				}
			}
		}

		d.comp[i].h = h
		d.comp[i].v = v
	}
	return nil
}

// 第B.2.4.1节规定。
func (d *decoder) processDQT(n int) error {
loop:
	for n > 0 {
		n--
		x, err := d.readByte()
		if err != nil {
			return err
		}
		tq := x & 0x0f
		if tq > maxTq {
			return FormatError("bad Tq value")
		}
		switch x >> 4 {
		default:
			return FormatError("bad Pq value")
		case 0:
			if n < blockSize {
				break loop
			}
			n -= blockSize
			if err := d.readFull(d.tmp[:blockSize]); err != nil {
				return err
			}
			for i := range d.quant[tq] {
				d.quant[tq][i] = int32(d.tmp[i])
			}
		case 1:
			if n < 2*blockSize {
				break loop
			}
			n -= 2 * blockSize
			if err := d.readFull(d.tmp[:2*blockSize]); err != nil {
				return err
			}
			for i := range d.quant[tq] {
				d.quant[tq][i] = int32(d.tmp[2*i])<<8 | int32(d.tmp[2*i+1])
			}
		}
	}
	if n != 0 {
		return FormatError("DQT has wrong length")
	}
	return nil
}

// 第B.2.4.4节规定。
func (d *decoder) processDRI(n int) error {
	if n != 2 {
		return FormatError("DRI has wrong length")
	}
	if err := d.readFull(d.tmp[:2]); err != nil {
		return err
	}
	d.ri = int(d.tmp[0])<<8 + int(d.tmp[1])
	return nil
}

func (d *decoder) processApp0Marker(n int) error {
	if n < 5 {
		return d.ignore(n)
	}
	if err := d.readFull(d.tmp[:5]); err != nil {
		return err
	}
	n -= 5

	d.jfif = d.tmp[0] == 'J' && d.tmp[1] == 'F' && d.tmp[2] == 'I' && d.tmp[3] == 'F' && d.tmp[4] == '\x00'

	if n > 0 {
		return d.ignore(n)
	}
	return nil
}

func (d *decoder) processApp14Marker(n int) error {
	if n < 12 {
		return d.ignore(n)
	}
	if err := d.readFull(d.tmp[:12]); err != nil {
		return err
	}
	n -= 12

	if d.tmp[0] == 'A' && d.tmp[1] == 'd' && d.tmp[2] == 'o' && d.tmp[3] == 'b' && d.tmp[4] == 'e' {
		d.adobeTransformValid = true
		d.adobeTransform = d.tmp[11]
	}

	if n > 0 {
		return d.ignore(n)
	}
	return nil
}

// 解码从r读取JPEG图像，并将其作为image.image返回。
func (d *decoder) decode(r io.Reader, configOnly bool) (image.Image, error) {
	d.r = r

	// 检查图像标记的开始。
	if err := d.readFull(d.tmp[:2]); err != nil {
		return nil, err
	}
	if d.tmp[0] != 0xff || d.tmp[1] != soiMarker {
		return nil, FormatError("missing SOI marker")
	}

	// 处理剩余的片段，直到图像标记结束。
	for {
		err := d.readFull(d.tmp[:2])
		if err != nil {
			return nil, err
		}
		for d.tmp[0] != 0xff {
			// 严格来说，这是一个格式错误。然而，libjpeg在其接受的内容上是自由的。从版本9开始，
			// jdmarker.c中的下一个_标记将此视为警告（JWRN_无关_数据），
			// 继续解码流。甚至在next_marker看到
			// 无关数据之前，jdhuff.c中的jpeg_fill_bit_缓冲区读取尽可能多的
			// 字节，可能超过扫描数据的结尾。它能有效地放回任何被过度屏蔽的标记（例如，一个
			// /“\xff\xd9”EOI标记），但它不会放回非标记数据，因此它能在下一个标记有机会看到它们之前默默地忽略少量无关的
			// 非标记字节（还有打印一条警告）。这与扫描中的重启机制类似，但并不完全相同（RST[0-7]标记）。
			// 
			// 请注意，例如SOS数据中的无关0xff字节转义为
			// “\xff\x00”，因此会在稍低的位置检测到。
			d.tmp[0] = d.tmp[1]
			d.tmp[1], err = d.readByte()
			if err != nil {
				return nil, err
			}
		}
		marker := d.tmp[1]
		if marker == 0 {
			// 将“\xff\x00”视为无关数据。
			continue
		}
		for marker == 0xff {
			// 第B.1.2节说，“任何标记前面都可以加上任何
			// 填充字节数，即分配给代码X'FF的字节数”。
			marker, err = d.readByte()
			if err != nil {
				return nil, err
			}
		}
		if marker == eoiMarker { // 图像结束。
			break
		}
		if rst0Marker <= marker && marker <= rst7Marker {
			// 本规范图B.2和B.16建议重启标记应只出现在熵编码段之间，而不出现在最终ECS之后。
			// 但是，某些编码器可能会在最后重新启动
			// 标记时生成不正确的JPEG。该重新启动标记将在此处显示，而不是在processSOS 
			// 方法中，并作为无害错误被忽略。重新启动标记没有额外的数据，
			// 所以在读取段的16位长度之前，我们先检查一下。
			continue
		}

		// 读取段的16位长度。该值包括
		// 长度本身的2个字节，因此我们减去2得到剩余字节数。
		if err = d.readFull(d.tmp[:2]); err != nil {
			return nil, err
		}
		n := int(d.tmp[0])<<8 + int(d.tmp[1]) - 2
		if n < 0 {
			return nil, FormatError("short segment length")
		}

		switch marker {
		case sof0Marker, sof1Marker, sof2Marker:
			d.baseline = marker == sof0Marker
			d.progressive = marker == sof2Marker
			err = d.processSOF(n)
			if configOnly && d.jfif {
				return nil, err
			}
		case dhtMarker:
			if configOnly {
				err = d.ignore(n)
			} else {
				err = d.processDHT(n)
			}
		case dqtMarker:
			if configOnly {
				err = d.ignore(n)
			} else {
				err = d.processDQT(n)
			}
		case sosMarker:
			if configOnly {
				return nil, nil
			}
			err = d.processSOS(n)
		case driMarker:
			if configOnly {
				err = d.ignore(n)
			} else {
				err = d.processDRI(n)
			}
		case app0Marker:
			err = d.processApp0Marker(n)
		case app14Marker:
			err = d.processApp14Marker(n)
		default:
			if app0Marker <= marker && marker <= app15Marker || marker == comMarker {
				err = d.ignore(n)
			} else if marker < 0xc0 { // 见表B.1“标记代码分配”。
				err = FormatError("unknown marker")
			} else {
				err = UnsupportedError("unknown marker")
			}
		}
		if err != nil {
			return nil, err
		}
	}

	if d.progressive {
		if err := d.reconstructProgressiveImage(); err != nil {
			return nil, err
		}
	}
	if d.img1 != nil {
		return d.img1, nil
	}
	if d.img3 != nil {
		if d.blackPix != nil {
			return d.applyBlack()
		} else if d.isRGB() {
			return d.convertToRGB()
		}
		return d.img3, nil
	}
	return nil, FormatError("missing SOS marker")
}

// applyBlack将d.img3和d.blackPix组合成一个CMYK图像。使用的公式
// 取决于JPEG图像是存储为CMYK还是YCbCrK，
// 由APP14（Adobe）元数据指示。
// 
// Adobe CMYK JPEG图像是反转的，其中255表示没有墨水，而不是完整的
// 墨水，因此我们在不同点应用“v=255-v”。请注意，双
// 反转是不可操作的，因此反转可能隐含在下面的代码中。
func (d *decoder) applyBlack() (image.Image, error) {
	if !d.adobeTransformValid {
		return nil, UnsupportedError("unknown color model: 4-component JPEG doesn't have Adobe APP14 metadata")
	}

	// 如果四分量JPEG图像没有按照
	// 或CMYK）”，我们假设它是YCbCrK。这与libjpeg的jdapimin.c相匹配。
	// https:
	// 明确标记为“未知（RGB 
	if d.adobeTransform != adobeTransformUnknown {
		// 将YCbCrK的YCbCr部分转换为RGB，反转RGB以获得
		// CMY，并在原始K中进行修补。RGB到CMY反转取消了
		// ，取消了上面applyBlack文档注释
		// 中描述的“Adobe反转”，因此在实践中，只有第四个通道（黑色）是倒置的。
		bounds := d.img3.Bounds()
		img := image.NewRGBA(bounds)
		imageutil.DrawYCbCr(img, bounds, d.img3, bounds.Min)
		for iBase, y := 0, bounds.Min.Y; y < bounds.Max.Y; iBase, y = iBase+img.Stride, y+1 {
			for i, x := iBase+3, bounds.Min.X; x < bounds.Max.X; i, x = i+4, x+1 {
				img.Pix[i] = 255 - d.blackPix[(y-bounds.Min.Y)*d.blackStride+(x-bounds.Min.X)]
			}
		}
		return &image.CMYK{
			Pix:    img.Pix,
			Stride: img.Stride,
			Rect:   img.Rect,
		}, nil
	}

	// CMYK 
	// 的前三个通道（青色、品红、黄色）被解码为d.img3，但每个通道被解码为单独的
	// /[]字节片，并且一些通道可能被二次采样。我们将
	// 单独的通道交错到一个图像中。CMYK的单个[]字节片包含4个
	// 每个像素的连续字节。
	bounds := d.img3.Bounds()
	img := image.NewCMYK(bounds)

	translations := [4]struct {
		src    []byte
		stride int
	}{
		{d.img3.Y, d.img3.YStride},
		{d.img3.Cb, d.img3.CStride},
		{d.img3.Cr, d.img3.CStride},
		{d.blackPix, d.blackStride},
	}
	for t, translation := range translations {
		subsample := d.comp[t].h != d.comp[0].h || d.comp[t].v != d.comp[0].v
		for iBase, y := 0, bounds.Min.Y; y < bounds.Max.Y; iBase, y = iBase+img.Stride, y+1 {
			sy := y - bounds.Min.Y
			if subsample {
				sy /= 2
			}
			for i, x := iBase+t, bounds.Min.X; x < bounds.Max.X; i, x = i+4, x+1 {
				sx := x - bounds.Min.X
				if subsample {
					sx /= 2
				}
				img.Pix[i] = 255 - translation.src[sy*translation.stride+sx]
			}
		}
	}
	return img, nil
}

func (d *decoder) isRGB() bool {
	if d.jfif {
		return false
	}
	if d.adobeTransformValid && d.adobeTransform == adobeTransformUnknown {
		// https:
		// 表示0表示未知（实际上是RGB），1表示YCbCr。
		return true
	}
	return d.comp[0].c == 'R' && d.comp[1].c == 'G' && d.comp[2].c == 'B'
}

func (d *decoder) convertToRGB() (image.Image, error) {
	cScale := d.comp[0].h / d.comp[1].h
	bounds := d.img3.Bounds()
	img := image.NewRGBA(bounds)
	for y := bounds.Min.Y; y < bounds.Max.Y; y++ {
		po := img.PixOffset(bounds.Min.X, y)
		yo := d.img3.YOffset(bounds.Min.X, y)
		co := d.img3.COffset(bounds.Min.X, y)
		for i, iMax := 0, bounds.Max.X-bounds.Min.X; i < iMax; i++ {
			img.Pix[po+4*i+0] = d.img3.Y[yo+i]
			img.Pix[po+4*i+1] = d.img3.Cb[co+i/cScale]
			img.Pix[po+4*i+2] = d.img3.Cr[co+i/cScale]
			img.Pix[po+4*i+3] = 255
		}
	}
	return img, nil
}

// 解码从r读取JPEG图像，并将其作为image.image返回。
func Decode(r io.Reader) (image.Image, error) {
	var d decoder
	return d.decode(r, false)
}

// DecodeConfig返回不带
// 解码整个图像的JPEG图像的颜色模型和尺寸。
func DecodeConfig(r io.Reader) (image.Config, error) {
	var d decoder
	if _, err := d.decode(r, true); err != nil {
		return image.Config{}, err
	}
	switch d.nComp {
	case 1:
		return image.Config{
			ColorModel: color.GrayModel,
			Width:      d.width,
			Height:     d.height,
		}, nil
	case 3:
		cm := color.YCbCrModel
		if d.isRGB() {
			cm = color.RGBAModel
		}
		return image.Config{
			ColorModel: cm,
			Width:      d.width,
			Height:     d.height,
		}, nil
	case 4:
		return image.Config{
			ColorModel: color.CMYKModel,
			Width:      d.width,
			Height:     d.height,
		}, nil
	}
	return image.Config{}, FormatError("missing SOF marker")
}

func init() {
	image.RegisterFormat("jpeg", "\xff\xd8", Decode, DecodeConfig)
}
